home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / src / sgml / sgml2latex-format.1.3.tar.Z / sgml2latex-format.1.3.tar / INSTALL < prev    next >
Text File  |  1993-05-12  |  2KB  |  52 lines
  1.  
  2. To use the qwertz documentation system, you
  3. will need, in addition to a Unix machine,  the following:
  4.  
  5. 1) LaTeX, TeX and BibTeX (and/or some nroff/troff, tbl, eqn and refer,
  6. such as groff);
  7.  
  8. 2) The epsf (Encapsulated Postscript File) TeX macro, if you want to
  9. be able to include PostScript graphics in your documents.   (Another
  10. macro package may be used instead, but you will need to edit the
  11. latex.rep file in the dtd directory.  See below.)
  12.  
  13. 3) James Clarks's sgmls and sgmlsasp tools.  They are are available
  14. from ftp.ifi.uio.no in the SGML/SGMLS directory.
  15.  
  16. To install format:
  17.  
  18.  
  19. 1) If your do not already have sgmls and sgmlasp, you will need to
  20. obtain them from and install them as described there.
  21.  
  22. 2) Edit the format, qtex, extract, qroff, preroff and biblio shell
  23. scripts in the bin directory.  You will need to change the path names
  24. of some of the shell variables at the beginning of each script.
  25.  
  26. 3) Make sure the commands are visible in your command PATH, either by
  27. adding this bin directory to your PATH variable, or by copying or
  28. linking these commands to files in some suitable directory, such as
  29. /usr/local/bin.  Add the man directory to your MANPATH.
  30.  
  31. 4) The reference manual is in the doc directory.  The SGML sources for
  32. the manual are included.  It is a "literate program" for the SGML
  33. Document Type Definitions.  That is, the DTDs can be extracted, using
  34. the "extract" command, from the manual.  A compressed postscript
  35. version of the manual is also included.
  36.  
  37. 5) The translation into LaTeX is controlled by the replacement files
  38. in the rep/qwertz and rep/biblio directories.  Feel free to customize
  39. these files, or create your own.  Each user can have his or her own
  40. mappings, to layout their documents according to their own
  41. preferences.  See the man page for format.
  42.  
  43. If you need any help, or have any suggestions or bug reports, please
  44. feel free to contact me.
  45.  
  46. Thomas F. Gordon        email: thomas@gmdzi.gmd.de
  47. GMD                 phone: (+49 2241) 14-2665
  48. Postfach 1240
  49. Schloss Birlinghoven
  50. 5205 Sankt Augustin 1
  51. Germany
  52.